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ABSTRACT 



Z7ii±E report discusses the development of an interactive computer 
program TEZLP) designed for student-oriented use in solving linear 
prograininl.uS probl^ins. The linear programming problem is inputted in 
-he same ^srsy as it would be written on a sheet of paper. 

The £-J:udent ^<iy select either the (primal) simplex or the dual 
simplex m=:ihod; the lower-upper bounded variables procedure with either 
method; arni real (0.5) or rational (1/2) arithmetic for the calculations. 
EZLP has iJitemal editing capability and is able to read Zrom and write 
to permanent files . 

During execution of EZLP, if the student has difficulty in remember- 
ing what to do next, he may utilize a HELP commaad to obtain general or 
specific infonuation on EZLP's use. 

Since EZLP was developed under a National Science Foundation grant 
a program listing on computer paper is freely available. A listing on 
cards or tape is available at a nominal charge to cover expenses* EZLP 
may not he resold* 

Finally, a simplified user's manual suitable for handout to students 
learning EZLP fot the first time is contained in Appendix A, 



Chapter 1; INTRODUCTION 
1,1 Backgro und 

Linear programming is a mathematical optimization technique utilized 
intensively in the fields of mathematics, management zz\i engineering — 
especially within the areas of operations research anc management science. 
The simplex method — the standard technique for solving linear programs — 
is an iterative method, and, as such, is dependent on ::he computer tc 
carry out the rote calculations. Computerized simpler codes are available 
in SEiall problem-solving vercious and in large production versions in most 
university, private and governmental computing centers. Students find 
that interaction with these computer codes is often very difficult* The 
result is that small scale usage in the classroom or laboratory or for 
homework is discouraged. This bad experience carries over and tends to 
discourage the student's use of linear programming on the job. 

In most universities today there are a number of undergraduate and 
graduate courses utilizing linear programming as a problem-solving tool. 
Georgia Tech is typical with as many as 6-10 undergraduate courses and 
15-20 graduate courses utilizing linear programming. In these cours^as 
the student is expected to develop modelling skills with linear program- 
ming, appreciate the simplex method (or its variants) as a solution tool 
and to interpret the output results of the simplex method in the parti- 
cular problem situation. In addition to course work there are usually 
a number of students performing research on new techniques which require 
a check by solving small linear programming problems. Hand calculations 
are good up to about four constraints and ten variables. Beyond this 
number the student must go to the computer in order to have the calcu- 
lations performed, otherwise, negative feedback results. The student 
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remembers the difficult; ith sol'rii^- :: niodel and not the pow» ^ of 
the modelling tec hnique When : .l^ : - gets to the c nputer he 
usually finds a \ le r.^ .-t of -^i^-_z-lries with regar- to the iaci 



that in order to . vie t ^3 :r: 
computer-oriented ^t £r 

A number of ii^iiHXi.-utiunr ■ 
Stanford Uni'-^rsi " che Ur:_ -ri-_ 
developed linear t~ rammirig 
student oriented i-^ rieir des.igr 
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;'ith his model he must leam a 
--riented) "input la-iguage", 

'-.'l Northwestern Univeirsity, 
: Z-::as, and Georgia Tech have 

r :5rr: grams which are i ore directlj 
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an experimental pre -t ha-, ^er -c-rway since 1971 to develop a student- 
oriented conversati— al 1.:: -ai :z::.-imiiing code (EZLP) for use on small 
problems (up to 50 zonstr: arc .jO variables). The innovation is 

in the special way tlr.at the ruder interacts with the computer. The 
student inputs his Linear pre gran, .ng model to the computer in exactly 
the same manner he -Jd .^^ri-^ it dovm on paper. Evolution of th^s 

code has been thr^^n cla. proje. .s . Despite limitations in its init^l 
design, EZLP was iZ- ithe^^^s widely accepted by the students. 



1.2 Initial Proj: 
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The Nationa^^Scuzr^ncc Foundation agreed to support a concerted 
effort, during th^ 75-1976 academic year, to redesign and develop a 
conversational cotzdu. .r code based on the concepts developed at Georgia 
Tech. 

To accomplish the iven task, a Georgia Tech team was organized. 
The Georgia Tech t.^^ c— isisted of: 
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Dr. John J. Jarvis, Projeat Director 

Frank H. Cullen, Research Assistant 

Chris Papaconstadopoulos . Research . r^istant 
^- team had the overall v ncnsibilit: resigning, dev^loring, coding 
u documenting the computr jsteiti. 

An Advisory Coniri ttee eminent re '^E.r hers and prac:::_tiOv:er s in the 
f .^Id of linear prog-- mi:- : las also org=iize to provide guidance to the 
Georgia Tech team. . -7i::ory Committr^- e xisted of the followinr, indi- 

viduals : 

1. Dr, Claude 
Northweste— Ur rrsity 

2. Dr. Harve" . : ^r.berg 
Federal rgy I. ministration 

3. Dr. Marvi - Gr Tin 
Universit i kl^oama 

4. Dr. Micha^ E. Thomas 
Universit rf Florida 

T:zis committee hac significant impact on :he design of the final computer 
s"^stem. 

1.3 Initial Project Plan 

During the early stages of the project the Georgia Tech team devoted a 
great deal of time and effort to the development and documentation of a 
preliminary design of a computer system for EZLP. This documentation was 
submitted to the Advisory Committee for their review. 

A meeting of the Advisory Committee was conducted on the Georgia Tech 
campus to discuss the preliminary design. This discussion lead to a much 
improved design. On advice of the committee, the fundamental concept of 



complete machine independence was replaced by a moderate level of S!achrr!.e 
dependence to permit substantia.!, reduction in program size and complej-ity. 
Also, a number of general features were eliminated from the initial Uesiigr. 
while many others were added. The Georgia Tech teaa was very pleised riti 
the structure that emerged from that meeting. 

The Advisory Conmittee also suggested, at its meeting, that tae G ic -gia 
Tech team retain a certain degree of flexibility in its development o' 
so that the Tech team might be able to react in an expeditious manner : 
potential difficult situations which could arise during coding. 

The remainder of the initial grant period, following the Advisor-/ 
Committee meeting, was spent developing and testing the EZLP code. itn 
a few changes, the initial EZLP system developed was the one which merged 
from the Advisory Coimnittee meeting. 

1.4 Follow-on Project Effor t 

The initial project phase concluded with the development of the basic 
EZLP system. The project then proceeded into a second phase consisting -f 
dissemination, formative evaluation, and modification/improvement. 

During the second phase, the dissemination task consisted of mailing 
literature on the basic EZLP system to approximately one nundred and fifty (150) 
departments of Industrial (and SystemiO Engineering, Operations Research, 
Management Science, Computer Science und Mathematics throughout the United 
States. The literature described the EZLP system, its functions and operation. 
Copies of the computer code were offered at nominal o:: no charge to interested 
institutions. The objectives of this offering were to (1) achieve wide dissemina 
tion of the project results, and (2) generate a subset of implementing institu- 
tions from which a formative evaluation of the EZLP system could be conducted. 



Some two dozen institutions :asted the EZLP code for implementation. 
It was anticipated that a group :i :e institutions, providing a cross 
section of EZLP users, vould be. .--i-fied for participation in a seminar 
on EZLP to be held at Georgia Te_:. Sotiever, it soon became evident that 
the critical link would not be -icerstanding the EZLP system, but, instead, 
vould be getting EZLP operatior^.1 or. the myriad of different computers 
(UNIVAC, Burroughs, Prime, IBM, =£c:,) involved. 

After discussions with NSF.. it was decided to carry the EZLP seminar 
to the users, instead of having the users come to Georgia Tech. A quali- 
fied graduate research assistant: was sent to several targeted institutions 
to (1) solve EZLP implementation problems, (2) give a seminar/demonstration 
of the EZLP system and its capabilities, and (3) establish the necessary 
mechanism for receiving comments and evaluations of the EZLP system. 
Several institutions were targeted on the basis of their interest and enthu- 
siasm and the type of computer system involved. It was hoped that the for- 
mative evaluation could include results of experience on as many different 
computer systems as possible. 

The implementation, testing and evaluation process proved invaluable 
to the continued improvement of the EZLP system. EZLP users evaluations 
included (1) modifications of the code to provide easier installation of 
differing computer systems, (2) changes in the materials, handouts, etc. 
describing EZLP and its uses, (3) expansion and improvement of the EZLP code 
to include additional features requested by the users, (4) modularization 
of the EZLP system to overcome the problems associated with core memory require 
ments for operation of the system, (5) changes in EZLP command structures and 
output formats to provide more intuitive understanding of the system opera- 
tion and results, and (6) the alleviation of minor bugs and difficulties asso- 
ciated with the EZLP system. 



The EZLP system which resulted from this testing and evaluation process 
is greatly improved. EZLP is currently operational on approximately two 
dozen computer installations throughout the United States. This list in- 
cludes acadmic institutions, governmental agencies and private firms. EZLP 
users report great popularity and success of EZLP. The Georgia Tech team is 
pleased with the resulting system and its acceptance by others. EZLP is 
becoming known worldwide, and already copies of the code have been sent to 
several European countries. 

The remaining chapters discuss the specific structure of EZLP and its 
use. Appendix A contains a simplified user*s manual which could be passed 
out to students learning EZLP for the first time. 

1.5 Machine Dependence of the EZLP System 

The EZLP computer system has been intentionally designed to minimize 
the level of machine dependence within the coi\straint of reasonable pro- 
gram size and complexity. EZLP has been coded in FORTRAN and special 
forms which may be available only on the CDC Cyber 74 (the machine used) 
are avoided. Those places in the code where machine dependence was unavoid- 
able are few in number and clearly identified. 

Section 2.8 of Chapter 2 discusses the required changes to convert 
the machine dependent portions of EZLP to other computer systems. 

1.6 Availability of the EZLP System 

Development of the EZLP computer system was sponsored by a grant from 
the National Science Foundation. As such, the EZLP computer system is 
freely available to anyone desiring a copy. A computer listing on paper 
is available at no charge. There is a nominal charge, to cover expenses. 



for a listing on cards or tape. EZLP may not be resold. For further infor- 
write 

Dr. John J- Jarvis, EZLP Project Director 
School of Industrial and Systems Engineering 
Georgia Institute of Technology 
Atlanta, Georgia 30332 

1 ,7 Continuing Effort 

EZLP is an evolving computer system. Effort continues at Georgia Tech 
to maintain and Improve the EZLP code. We invite comments and suggestions 
on improving EZLP. 



Chapter 2: EZLP - A NARRATIVE DESCRIPTION 



ERIC 



2>1 Introduction 

This chapter presents the workings of EZLP in a narrative form. 
Emphasis is given to the identification of the components of EZLP, their 
attributes, and a discussion of their mutual interaction. Coded in standard 
FORTRAN, EZLP nonetheless ha«^ certain functions which cannot be written in 
machine-independent code. Inese are discussed in the last part of this 
chapter. 

2.2 A General Outline 

In overview, EZLP consists of three main subprograms tied together by 
a controlling main program, or "driver." The three main subprograms are: 

a. Editor - the ability to create and maintain (update) a current 
model : ^ physically in an exterior mass storage device 

b. Syv. , : -■. .-r.alysis - inputting the model statements from the ex- 
tenial xii v ^-eated by the EZLP Editor, performing parsing 

and syjit ax- checking operations, and generating a tableau 
for input to the optimization process 

c. Optimization - a solution and output of a model in tableau forra 
by simplex procedures 

Figure 2.1 presents a general diagram of the program flow of EZLP which 
also indicates the interaction of the three main subprograms. 

2.3 The Driver 

The main program, or driver program, has several functions. Among 
these are: 

a. distribute and pass control among the three main subprograms 

b. perform ancillary operations not handled by the subprograms 
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Upon program execution, the driver program assumes control and examines 
the first input statement. If the keyword (the first word) of the input 
statement is an editor associated keyword (e.g., AND, MIN, CHANGE), the 
driver continues to parse the input statement to determine the row name 
if it is there and to construct the default value if it is not; control is 
then passed to the editor subprogram. If the keyword of the input statement 
is associated with an ancillary operation (e.g., RUN, SAVE, or PRINT), the 
driver continues to parse the input statement to determine what internal 
program switches are to be set, and in the case of the SAVE statement, per- 
form the requested file operations. If the keyword is USE, to trigger 
a solution attempt, the driver parses the remainder of the input statement 
to determine the simplex method to be used, passes control first to the 
syntactical analysis subprogram, and then to a tableau-building subroutine 
and the optimization subprogram in succession, if there are no syntactical 
errors in the model. 

In Figure 2.1 the driver program may be considered to be everything 
not within a subprogram boundary. 

2.4 The Editor 

The editor subprogram is primarily responsible for model file maintenance 
and performs four principal functions: 

a. Adds a statement to the model file 

b. Deletes a statement in the model file 

c. Changes a statement, in the model file 

d. Lists either a single row or the entire contents of the model file 

Model File Organization 

The model file itself is a simple linked-list structure with chaining 
used for continuation lines. Two vectors in the COMMON block EDIT, CNTNME 
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and LINKS, store the alpha name and the relative location of the first 
record for the particular row of the model on mass storage. This record 
has a forward link to a continuation record if used. This forward link 
is zero (0) if there are no further continuations after the current record. 
The program logic and passed parameters to the mass storage read and write 
subroutine are such that first-available and other random access techniques 
can be used on computers of various manufacture. 

Subprogram Operation 

Upon passage of control and the appropriate parameters, the Editor ac- 
cesses the model file to perform the desired function, and returns control 
to the driver which then reads in the next input statement. 

Continuations of rows in the model are handled directly by the Editor, 
which reads in successive input statements and sets up the chaining relation- 
ship until the continuation situation no longer exists. 

2.5 Syntactical Analysis 

The syntactical analysis subprogram is the process wherein the model 
file contents are read in, parsed, checked for errors in syntax, and trans- 
lated into a coded form which is subsequently transformed into a tableau 
structure. 

In overview, the syntactical analysis subprogram has two main entities: 

a. the model statement parser, which takes lines from the model file 

and generates a uniform symbol table in which the components of the 

model line (e*g. coefficient, name or identifier, delimiter) are 

» 

described and; 

b. the analysis routine which uses as input the uniform symbol table, 
checks for syntax errors, and outputs a quasi-diagonal tableau 
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which later serves as input to a tableau-building SL^broutine which 
adds slack and artificial variables and generates a rectangular 
tableau structure. 
Other output from the syntactical analysis subprogram includes: 

a. a vector containing row names as they appear in the tableau 

b. a vector containing variable names as they were first mentioned 
in the model file 

c. vectors containing lower' and upper bounds for each variable in 
the same order as (b) 

d. A designator of which rows of the table?*" are associated with ob- 
jective functions 

e. an indication of which objective function row is to be optimized 
during phase two of the optimization process 

In the instance that there are syntax errors present in the model file, 
descriptive error messages and pointers are printed in an attempt to pin- 
point the exact location of the trouble. 

The memory locations used by the syntactical analysis are focused in 
the COmON area OPT and WORK. 

2,6 Optimization and Output 

The optimization and output subprogram is the process by which the 
simplex operations are performed on the rectangular tableau created by the 
tableau-building subroutine which, in turn, receives its input from the syn- 
tactical analysis subprogram. Depending upon the value of the parametric 
switch METHOD^set by the driver program during the parsing of the USE state- 
ment, the optimization process selects from four basic algorithms: primal 
or dual simplex with or without rational arithmetic. The lower^-upper bounded 
simplex approaoh is used throughout the optimization routines. The different 
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results obtained by the specification of th- UPPER parameter in the USE 
statement owe to the generation of explicit bound constraints by the syn- 
tactical analysis subprogram when UPPER 1.: not specified. 

The primal algorithir-j (real and rati )nal) employ a two-phase method 
for which the Phase 1 objective function and the starting basis are de- 
termined by the tableau-building subroutine* At the successful completion 
of Phase 1, the Phase 2 objective function (which has been stored as a null 
constraint in the tableau) is written over the Phase 1 objective function 
and the process resumes. 

The dual algorithms begin with the creation of the Phase 2 objective func- 
tion from the appropriate null constraint (objective function) in the tableau. 

The rational algorithms require the maintenance of both a numerator 
and a denominator for each tableau entry (and each element of the right- 
hand side). For example, the numerator for an element in an array may be 
stored in position I, while the corresponding denominator will be stored in 
position J+I, where the Jth position of the array held the value of the 
numerator of highest subscript index. 

At the end of each simplex iteration, or both before and after the 
optimization process has been completed, there might be output specified 
by the user via a PRINT statement. In this instance, control within the 
optimization process is passed to a point which prints out the values of 
the nonzero variables, the current basis and basis activity, or the current 
tableau and updated objective function. Control is then returned to the 
appropriate place in the optimization process. 

Upon reaching an optimal solution, control within the optimization process 
passes to a point at which the default output (the optimal primal and dual 
solutions) is printed out. Even if no other output is specified or requested, 
the default output is printed. 




When the printing default output is completed, control returns to the 
driver program which then reads in and parses the next input statement. 

The memory locations used by the optimization and output subprogram 
are focused in the COMMON area OPT and WORK. 

2 . 7 Segmentation ^ EZLP 

In dealing with computers with smaller capacity than large-scale university 
computing systems, niemory economy via code segmentation or overlay is often 
of considerable interest. 

The modular subprogram concept allows some or all of the subprogram code 
to be overlayable, and hence less wasteful. 

Specifically, the three subprograms are mutually overlayable as well 
as those functions which serve only one of the subprograms. Graphically, 
we can represent the code components of EZLP as a tree, the root of which 
is non-overlayabie, and the separate branches of which form the overlays. 
In Figure 2»2, this tree structure is represented in terms of the actual 
FORTRAN' subroutines and function names. 
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Figure 2.2: Segmentation Tree -Structure of EZLP 
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2,8 Machine Dependence of EZLP 

There are two aspects of the code of EZLP which are likely to cause 
difficulties when an attempt is made to convert the code to a machine 
other than the one for which EZLP was written (the CDC Cyber 74). These 
are 

a. Alpha variables - packing txid unpacking, and manipulation 

b. File manipulations - particularly with respect to error 
and end-Of-file conditions 

Alpha Variables 

The storing of alphanumeric information In variables has always been 
a weakness in the design of FORTRAN. Consequently, the use of either integer 
or real variables to store alphanumeric information is bound to be non- 
standard .and change from machine to machine. For the purpose of program 
design and implementation, EZLP uniformly uses real variables. For those 
compilers and computers which require that some other type be used for 
alpha variables, explicit type statements must be added to those portions 
of the code affected for the alpha variables. 

A basic assumption of the EZLP code is that the alpha variables can 
hold at least eight (8) characters and are appropriately filled so that 
a comparison with a Hollerith constant is meaningful. Hexadecimal machines 
(or character machines) normally have type statements which allow the length 
of the variable in bytes (characters) to be specified. IiJhere applicable, 
these constructs should be used. 

An often-used subroutine in EZLP for composing a single eight-character 
alpha variable from eight single-character alpha variables is called PACK. 
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This subroutine is totally machine-dependent and must be changed for dif- 
ferent computers. 

File Manipulation 

EZLP employs a number of files during execution. These files are 
summarized in Table 2.1. These files, with the possible exception of fil<^ 
are strictly sequential files and require no special programmatic consider 
File 8, the model file, because of the random way in which editing is applied 
to it, can be effectively used as a random access file. Since random access 
is normally a machine-^dependent function, EZLP separates out the random 
access read and write functions into separate subroutines MSREAD and MSWRIT. 
These two subroutines must be re-written for different computers. 

TabI: 2.1: EZLP Files and Their Description 



File Number Description 

5 Input file (from the terminal) 

6 Output file (to the terminal) 

7 Message file (for syntax error messages) 

8 Model file (linked and chained mass storage) 

9 RuTA file (alternate input file) 

10 Save file (model output file) 

11 Help stored-text file (instructions) 



End-of-file checking is also achieved differently with different FORTRAN 
compilers. On the CYBER 74, the test is the implicit function EOF(u). 
Occurrences of this function should be replaced by the appropriate READ 
statement construct for the local FORTRAN compiler. For example, the sequence 

READ (INFILE, 102) (BUFFER(I), 1=1, 80) 
IF (EOF(INFILE) .NE.O) GO TO 320 
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could be replaced by something resembling 



READ (INFILE, 102, END=320) (BUFFER(I), 1=1, 



if such was the appropriate end-of-file construct. 



17 

Pi 



C hapter 3: USER INSTRUCTIONS 

3.1 Introduction and Notation 

This chapter Is designed to describe the operation of EZLP from the 
user's point-of-vlew. The material covered here is somewhat more com- 
prehensive than that which would be required for the user with simple 
problems. Appendix A contains a simplified user's manual. 

For clarity of presentation, this chapter uses BNF notation in de- 
scribing syntactical rules. Briefly, capitalized words indicate keywords, 
[] indicates an optional clause, | [ Indicates a choice of two or more 
alternative's, and <> enclose a descriptive term for a syntactical entry. 

3.2 Starting EZLP 

The exact syntax of executing EZLP will vary from computer to computer 
and from installation to installation, and so cannot be explicitly stated 
here. For the sake of clarity, let it be assumed that EZLP has been exe- 
cuted and is awaiting input from the user. 

At this point, the user has the option of proceeding to enter the model 
(3.3) or getting a brief (about two pages) description of how EZLP is operated. 
This description, in the absence of this chapter or other documentation should 
supply a minimtni of information to the user so that he can use the program. 
To obtain this brief description, the user must enter the following command: 

HELP BRIEF 

This command is discussed further in section 3.7. 

3.3 Entering the Model 

The first thing the user must do is enter the model. The entry of the 
model follows certain rules - there are rules concerning the order in which 
inputted statements must be organized, and there are rules which govern the 
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way in which different types of statements are made up. Before these rules 
are discusjied, it would be best if somr^ basic ideas were explained: A 
statement is a single logical input. A constraint is a statement- The 
objective function is a statement. A delimiter is a single character which 
serves to terminate one entry and perhaps begin the next. For the entry of 
the model, the space character is the usual delimiter. A name provides 
the convenience of letting the user assign unique identifiers to variables, 
constraints, and objective functions. The names themselves are composed 
of from one to eight characters. The first character must be alphabetic 
(A-Z), while the remaining characters must be alphabetic, numeric (0-9), 
or numerics separated by commas. X2, PROFIT, ITEMS i and Y2,3 are examples 
of acceptable names, while ITEM-3 and $VAR are not. A space character 
cannot be part of a name. EZLP reserves certain names for its internal 
use. Row names of the form ROW#n are reserved for each objective function 
or constraint statement which was unnamed by the user. This generated 
name can be used for editing purposes. In addition, EZLP uses the names 
SLK#n and ART#n for the slack and artificial variables that it generates. 
Since the user may not input any name containing the * character there can 
never be any confusion between user-generated names and EZLP-generated 
names. An input-line corresponds to a line of input on the terminal. In 
batch processing, this is equivalent to a card image. 

If desired the user may indicate that heading information is to be 
printed at the top of the optimal solutipn output. The user must type 
in 

TITLE <heading information > 

where < heading information> appears as a heading at the top of the output. 
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The actual entry of the model is divided into two basic parts: the 
objective function and the constraints. 

Entering the nhlective Function 

The syntactical rule for the entry of the objective function is: 



(MIN \ „^ i MINIMIZE \ r<ob jective-f unction-name>] : <arithmetic 
1 MAX / M MAXIMIZE I L 



expression> 



where <objective.function-name> is an optional user-assigned name for the 
objective function and <arithmetic expression> is a linear combination of 

variable-names. 

Note that the colon (:) is required at all tim8s. 

If the objective function statement is too large to be entered on one 
input line, continuation of the statement is accomplished by placing an 
ampersand (M, after the last character of the current input line and con- 
tinuing the statement on the next input line. There are no limits on the 
number of continuations allowed for a single statement. 
Examples of possible objective function statements: 

1. MIN: 2 + 3X2 - 2.3X4 

2. MAX PROFIT: 3INC0ME - UEXPNSE - .6730VERHD 

3. MIN COST: 2.UVAR1 - 3.53VAR2 + .0OUVAR3 & 
-VAR4 

Alternate O hifictive Functions 

in some applications of linear programming, it is of interest to con- 
sider a number of possible objective functions subject to the same set of 
constraints. EZLP allows for the entry and subsequent optimization of the 
entered model in coordination with alternate objective functions, 
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The syntactical rule for the entry of an alternate objective function 

is: 

ALSO [<objective-function-aame>] : <arithmetic expression> 

Notice that the above differs from the ordinary entry of the objective 
function in that the keyword "ALSO" is required ar^^ eplaces the keywords 
"MIN" and "MAX". 

Each model must contain exactly one primary objective function (using 
the keywords "MAX" or "MIN") . However, a model may contain any number of 
alternate objective functions. EZLP operates with only one objective 
function at a time. 

Specifying an alternate objective function for the purpose of optimi- 
zation is accomplished just prior to specifying the method of solution. 
This is discussed in Section 3.5 ii. 

Entering the Constraints 

The constraints associated with normal linear programming model can be 
broken down into three general classes: 

1. Simple arithmetic constraints - those constraints which involve 
more than one variable and only one relational operator; and 

2. Range constraints - those constraints which involve more than one 
variable and two identical operators; and 

3. List constraints - those constraints which involve only one 
variable. Constraints of this type usually specify upper or 
lower bounds on a particular variable or a list of variables. 
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Simple Arithmetic Const-rA-f n-o 

The syntactical rule for the entry of a i . . 
i,. ^ °^ ^ "^""P^^ arithmetic constraint 



{and} r<°°n3traint.name>J: <arithmetic expression> 



<relational operator> <arithmeti 



c expre33ion> 



-3 ^3 ..... ^ 
operator, takes one of the fon„„i„g f ^..^ 

1- {=>or >=j (greater than or equal to) 



- (equal to) 



3. j = <or<=} (less than or equal to). 
Mote that the eolon is required at all times. 

Xf an, particular constraint statement Is too large to .e entered on 
one output line continuation of the statement Is acccpUshed placing an 
~ (. after the last character of the current Input line L con 
"7 - — t on the ne.t Input line, .ere are no limits on the 
nu..er of continuations allowed for a single constraint statement. 

first constraint statement should .e^m with the .ey.ord "sr. „hlch 
Stands for "subient- f«» o . wnxcn 

3uhject to", subsequent constraint statements .ust begin with 
the keyword "AND". 

Constraint statements which 'nclude thp nnf. . 

-nciude the optional <constraint-name> 
are easily referenced for ertiUnrr k 

edxting by thxs user-assigned name. Unnamed con- 
stramts are assigned a name by EZLP 30 th«f fv, 

y t^LP 30 that the user can also reference 
and edit these constraints. This is fnpfh.,, 

inis is further- discussed in section 3.4 

Examples of possible simple arithmetic constraints: 
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1. 

2. 
3. 



AND CNSTR2: 20WIDTH2 <= 15 - LENGTH 
AND POWER: TOTAL + 3TIMEAVL> = 16.45 
AND: 4.3X1 + 6X7 = 4.57 



Range Constraints 

EZLP is designed to accommodate range constraints. The syntactical rule 
for .the entry of range constraints is: 

IaNdI [<°°"s*^^^i"t-"2une>] : i;constant-lXinequality-operator-l> 

<arithmetic expression ><inequality-operator-2Xconstant-2> 

where the following rules apply: 

1. <inequallty-operator-l> and <inequality-operator-2> must 'oe exactly 
alike and must be either >= or <=. 

2. If the relational operators are >=, then <constant-l> must be 
greater than or equal to <constant-2> 

3. And, if the relational operators are <=, then <constant-l> must be 
less than or equal to <constant-2>. 

Examples of possible range constraints are: 

1. AND: 4 <= 3x1 + 4.2x3 - 4x4 <= 6.2 

2. AND WORKERS: 500 >= 6.3FORCE1 - 5.3FORCE2 >= 243 

3. AND CONSTRNT: 3.4 <= 7+ VAR3 =<8.46 

List Constraints 

The syntactical rule for the entry of a list constraint is: 

r |alL [other VARS I i <relational operator><bonstant> 

AND [<constraint-narae>J: < <variable.list> ]\ URS 
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where <constraint-name> and <relatlonal operator^ are described above for 
simple arithmetic constraints; and <variable-list> is a list of one or 
more variable names, separated by commas (,). 

The reserved phrase "ALL VARS" indicates that the bound specified ap- 
plies to all variables in the model. The reserved phrase "ALL OTHER VARS" 
indicates that the bound specified applies to all variables which are not 
included in another list constraint for the same type bound (i.e., upper 
or lower) . 

The reserved word "URS" stands for "unrestricted in sign". 

The default option for all variables if they do not appear in a 
list constraint is "URS". EZLP prints a notification of the unrestricted 
variables. 

Examples of possible list constraints: 

1. AND: XI, X2, X3 < = 0 

2. AND: ALL VARS > = 0 

3. AND: OIL <= 375.^3 

^4. AND: ALL OTHER VARS < = 1 

5. AND: PROFIT URS 

6. AND MYCNSTR: WIDTH, LENGTH > = 0 
An example of an entry of a complete model: 

MIN: 10.5WIDTH1 + 11.8WIDTH2 - 30LENGTH 
ST CNSTRl: 15LENGTH - 2WIDTH1 < = 10 
AND CNSTR2: 20WIDTH2 + LENGTH < = 15 
AND: ALL VARS > = 0 

3.4 Editing the Model 

After completion of the model entry, the user has the ability to per- 
form certain editing functions. These functions are: 
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1. Adding a constraint or objective function 

2. Deleting a constraint or objective function 

3. Changing a constraint or objective function 
M. Listing the model in whole or in part 

i) Adding a Constraint or Objective Function 

At all times the user has direct access to his model. Thus, addition 
of a new constraint or objective function to the end of the current model 
may be accomplished by simply typing the appropriate constraint or objective 
function statements. EZLP will automatically append the new statement to 
the previous model. 

For example, suppose that the user has attempted to solve his model and 
this attempt resulted in an unboundedness indication. Having determined 
that he failed to require nonnegativity he may do so by simply typing 

AND: ALL VARS > = 0 



If one wishes to insert a constraint into the middle of the current 
model, this may be accomplished by typing 

INSERT jfiEFoLl {model entry statement} 

where <model entry statement> is either a constraint or objective function 
statement. Examples of the INSERT command are: 

1. INSERT AFTER R0W#2 AND: XI + 2X2 <= 7 

2. INSERT BEFORE C0NST6 AND C0NST5 : 7 <= XI <= 9 

3. INSERT AFTER R0W#3 ALSO: 3X1 + 2P0WER 
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The syntactical rule for the deletion of a constraint 



DELETE <row-name> 

where <row-name> is either the user assigned name, or in the absence of 
this name, the row name assigned by EZLP. The assigned name is simply 
ROW#n, where n is the number of the model entry as it was entered. Ex- 
amples of assigned row-names are ROW#U, R0W#13, and R0W#123. 

1. DELETE R0W#13 

2. DELETE SURPLS 

iii) Changing a Constraint or Objective Function 

The syntactical rule for the changing of a constraint or the objective 

function is: 

CHANGE <row-nam^ "<stringl>'<string2>" 

where <row-name> must be identical to some existing row name. 

The CHANGE command will replace <stringl> by <3t.ring2>. The construct 
"<3tringl>"" will delete <stringl>. 

Examples of possible CHANGE statements are: 

1. CHANGE CONSTRl "ENG"G" 

2. CHANGE SURPLS "3.2"" 
iv) Listing the Model 

The syntactical rule for listing the model on the terminal is: 

LIST [<row-narae>] 
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Where the optional <Po«-„a.e> is included if only . single .o„ i3 to be 
printed, u <ro„-„a.e> is o.itted the entire .odel „iu be printed, bx- 

amples of possible LIST commands are: 

1. LIST 

2. LIST H0W#5 

3. LIST MYCSTR 

3.5 So lving the MnH^i 

the user takes the following steps: 

1- Specifying the Desired Outnnf- (¥v.i^ ^ 

output (this step xs optional and, if omitted, 

results in only the optimal solution being printed). 

2. specifying the Objective Function to be Optimized (this step is 
optional and is only to be used when selecting an alternate ob- 
jective function). 

3. Specifying the Method of Solution, 
i) Specify ing the Desired Output 

If the user wishes to obtain more output than the optimal solution he 
may use the PRINT command. 

The syntactical rules for the PRINT command are: 



( VARS j 
I BASTS / 

PRINT [INIIIAL] [FINAL] TABLEAU [,<fre,uenoy count>] 

/ ALL j 

1 NONE ) 

This statement oonoerns the output on the terminal of infcr^ticn 

direotl, related to the optimization process. The following desoriptions 
apply: 
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VARS: prints the name and value of each nonzero primal variable; 

and the name and value of each nonzero dual variable. 
BASIS: prints the names of the variables in the basis and the objective 

function value. 
TABLEAU: prints the tableau. 
ALL: prints all of the above. 

NONE: prints only the optimal solutoln. 

<f requency-count>~the PRINT statement is executed every <frequency-count> 
iterations. If this optional clause is omitted, the PRINT 
statement will be execuuM after every iteration unless the 
keywords INITIAL and/or FINAL are used. When ALL or NONE 
are present <frequency-count> is ignored. 

INITIAL: prints the requested information only for the initial iteration. 

FINAL: prints the requested information only for the final iteration. 
(Note that INITIAL and FINAL may be used together.) 

Examples of possible PRINT commands are: 

1. PRINT VARS 5 

2. PRINT ALL 

3. PRINT BASIS, VARS, 3 

4. PRINT FINAL TABLEAU 

5. PRINT INITIAL, FINAL BASIS 

ii) Specifying the Objective Function to be Optimized 

In the event that the user has entered alternate objective functions, 
he may wish to specify the name of the objective function to be optimized. 
If this is not done, EZLP defaults to either the original objective function 
entered with the model or the last objective function name specified in a 
prior ALTOBJ statement. The syntactical rule for the specification of the 
objective function command is 
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ALTOBJ 



I MIN \ ^ , . 



ective-function-nanie> 



If an ALTOBJ command has been previously given, then to determine the 
row name of the current objective function being used, the user should type 



iii) Specifying the Method of Solution 

The specification of the method of solution triggers an attempt by 
EZLP to solve the entered model and produce output as specified in 3.5.i. 

The syntactical rule for specifying the method of solution is: 



become "1/2". Since the RATIONAL option requires storing both a numerator 
and a denominator matrix, the maximal allowable problem size is cut in 
half under this option. Further, all coefficients and constants must be 
entered as integers. 

Specifying UPPER before PRIMAL or DUAL will cause the lower-upper 
bounded primal or dual algorithm to be used. 

Examples of possible USE commands are: 

1. USE PRIMAL 

2. USE UPPER DUAL 

3. USE RATIONAL PRIMAL 

4. USE RATIONAL UPPER PRIMAL 



ALTOBJ 



STATUS 




Specifying RATIONAL keeps all data in rational form, i.e. "0.5" would 
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3.6 Sensitivity Analysis of the Results 

Once an EZLP model has been optimally solved by any of the USE commands, 
the user has the option of requesting a sensitivity analysis of the cost 
coefficients or the right-hand-side constants. The syntax of this command 
is: 



RHS 

RANGE ( OBJ or OBJFCN 
ALL 



< name 



n 



ALL 



The effect of the RANGE command is the determination of lower and upper 
limits on various model parameters which maintain the current (optimal) 
basis. Examples of possible RANGE commands and their effects are: 



COMMAND 



EFFECT 



1. RANGE RHS R0W//1 

2. RANGE OBJ X22 

3. RANGE OBJ, ALL 

4. RANGE ALL 



Provides lower and upper sensitivity 
limits for the right-hand-side con- 
stant for the ROWtfl constraint. 

Provides sensitivity information for 
the cost coefficient for variable X2? 
in the objective. 

Provides sensitivity information for 
all objective function coefficients. 

Provides sensitivity information for 
all objective function coefficients 
and all right -hand-side constants. 



If a constraint specified in the 
constraint, then separate sensitivity 
lower constant and the upper constant 



RANGE command is, itself, a range 
information will be printed for the 
of the constraint. 
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3.7 Restarting and Terminating EZLP 

At the completion of any model solution the user has three options: 

1. Editing the current model and re-solving it, 

2. Starting fresh with a new model, or 

3. Terminating EZLP 

The first of these options is accomplished by simply entering the ap- 
propriate edit statements (see 3.4) followed by the appropriate USE commands 
(see 3.5) • 

The second of these options is accomplished by the RESTART command. 
The syntax of this command is: 

RESTART 

The RESTART command re-initializes all areas. The effect of this command 
is to clear out the current model and print options. 

Terminating EZLP is accomplished by the END command. The syntax of 
this command is: 

END 

3>8 The HELP Command 

This command allows the user, after he has started the program, to 
obtain a short set of instructions on how to solve simple LP problems. The 
laser,* at any point in his run, may request additional help in. the following 
manner: 

HELP [<keyword>] 
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where the optional clause keyword refers to abbreviated instructions con- 
cerning a particular area of interest. A list of keywords is: 
General Keywords: 

BRIEF (briefly describes the general features of EZLP) 

EDIT (describes edit commands) 

EXAMPLES (presents examples of EZLP models) 
FILES (discusses external file handling capabilities) 

(gives the current list of keywords) 



KEYWORDS 
SOLVING 



(indicates the methods and options for optimization 
and discusses output options) 

(discusses model entry syntax) 



MODEL 
Specif ic Kejrwords: 

ADD (indicates how to add a constraint or objective) 

ADVANCED (presents an advanced example) 

ALTOBJ (indicates how to specify an alternate objective 

function for optimization) 

CHANGE (indicates how to change a constraint or objective) 

CONT (discusses the continuation of model statements) 

CONS (describes the options for inputting constraints) 

DELETE (indicates how to delete a constraint or objective) 

LIST (discusses th list options for model display) 

NAMES (provides a definition of acceptable variable names) 

OBJ (discusses objective functions) 

PRINT (discusses the output print options) 

RUN (describes procedure for inputting a model from an 

external file) 

SAVE (discusses procedure for saving a model) 

TITLE (discusses the options for method of optimization) 

USE (provides a definition of acceptable variable names) 
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If the keyword is omitted, EZLP will print a short description of how 
to obtain additional information on the operation of EZLP. 

3,9 External File-Handling Capabilities 

There are certain situations wherein the user wishes to eliminate input 
effort by storing all or part of his input on a mass storage device. EZLP 
provides for this capability with two commands: the RUN command and the SAVE 
command • 

I) The RUN Command 

At any point in the execution of EZLP, the user may elect to refer 
EZLP to a mass storage file for subsequent input. Tt^is input must be in 
the form of 80 character source records and must be accessible sequentially 
by EZLP. The sjmtax of the RUN command is 

RUN <file-name> 

If the RUN command is inputted, EZLP will read the model directly from 
the working file <file-nam^, print a question mark and await the next 
command. 

II) The SAVE Command 

Upon completion of model entry, the user may elect to save the input 
model in source form in a mass storage file. The syntax of the SAVE 
command is 

SAVE <file-name> 

If the SAVE command is inputted, EZLP will write the current model into the 
working file <f ile-nam^, print a question mark and await the next command. 
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Chapter 4t TERMINAL SESSIONS 



4.1 Introduction 

This chapter contains several examples of EZLP used to solve normal 
linear programming problems. These examples include: 

1, Simple example - getting on, solving a simple 

problem, and getting off, 

2. Advanced example - naming rows, editing the model, 

requesting additional output, 
and respondirig to an error in 
syntaxe 

3, Transportation problem example - two sources and two sinks to 

illustrate multiply- indexed 
variable names and the treat- 
ment of primal redundancy • 

4. Branch and Bound example - assignment of titles to optimal 

solution output in addition to 
using the editing features of 
EZLP to easily solve a small 
integer programming problem 
using the Branch and Bound 
method. 



5. Sensitivity Analysis - ranging applied to all constraints 

and all variables of a simple 
example. • 



EKLC 
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&.2 Session 1; A Simple Example of EZLP 



??PE HELl'*fF°YOu''HAiE*OUESTIONS, OTHERWISE PROCEED 
? HAX: 3X1+2X2 
7 ST: 5X1+3X2 <= 19 

7 And: xi-x2 >= 3 
7 and: all vars >= o 
7 use rational primal 

** no unrestricted variables in the model ** 
## variable- list ** 

XI X2 



SOLUTION 

OBJECT MAXIMIZE R0U41 

Z 23/2 
ITERATIONS 2 

UARIABLESECTION 
NAME """aCTIVITy"lEVEL LOWER BOUND UPPER BOUND REDUCED COST 
XI 7/2 0 PCS INF 0 

X2 1/2 0 



POS INF 0 



constraintsection 

NAME Il1177c7i7uY dual PRICE RHS VALUE 

R0U*2 0 5/8 1/2 

R0W*3 . 0 -1/8 7/2 

? END 

,223 CP SECONDS EXECUTION TIME 



4«3 Session 2; An Advanced Example of EZLP 



EZLP - VERSION 9/17/76 . ^ps««r-r-^ 
TYPE HELP IF YOU HAVE QUESTIONSr OTHERWISE PROCEED 

7 MIN: 4*3 A - 5*6 B ++ 7 C 

?ST:A + C = B-f7 

? AND BOUNDA: a <+ C + 7 

? CHANGE BOUNDA '<+'<=■ 

AND BOUNDA: a <= C + 7 

? AND BOUNDB: 1 <= B <= 6 

? and: a>= 0 

? USE UPPER PRIMAL 



MIN: 4.3 A - 5*6 B ++ 7 C 

1 

FATAL ERROR * 1 : ARITHMETIC OPERATOR IN WRONG PLACE 



** UNRESTRICTED VARIABLES ** 



FATAL ERRORS IN THE MODEL. 
PLEASE EDIT THE MODEL 
INPUT WILL BE RECOMPILED 
? LIST 
B0W#1 

MINJ 4.3 A - 5.6 B ++ 7 C 

R0Wt2 

st; A + C = B + 7 

BOUNDA 

AND BOUNDA : A <= C + 7 
BOUNDB 

AND BOUNDB : 1 <= B <« 6 
R0W«5 

and: a>= 0 
? change r0w*1 •++'+" 

MIN: 4.3 A - 5.6 B + 7 C 
? PRINT FINAL ALL 
? USE UPPER PRIMAL 

## UNRESTRI CTED VARI ABLES ** 

C 

** VARIABLE LIST ** 



A B C 



I 
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PHASE 2 ITERATION - 1 CURRENT OBJ VALUE = .3015E+02 
PRIMAL NON-ZERO VARIABLES 
A BASIC WITH VALUE .7500E+01 

B NON-BASIC WITH VALUE .lOOOE+01 

C BASIC WITH VALUE .5000E+00 

DUAL NON-ZERO VARIABLES 
R0U*2 DUAL = .565E+01 
BOUNDA DUAL = -.135E+01 
THE CURRENT BASIC VARIABLES ARE - 



CURRENT TABLEAU - 

RHS A B C 

-.302E+02 0. .500E-01 0» 

.500E+00 0. -.500E+00 
.750E+01 .lOOE+01 -.500E+00 



R0U«1 
C 
A 



UPDATED OBJECTIVE FUNCTION ROW 



SLK*3 
.135E+01 
•lOOE+Ol -.500E+00 
0. .500E+00 



-.500E-01 0. 



-.135E+01 



SOLUTION 



OBJECT 
Z 

ITERATIONS 



MINIMIZE R0U*1 
.3015E+02 

1 



VARIABLE SECTION 
NAME ACTIVITY LEVEL LOWER BOUND 

A .7500E+01 0. 

B .lOOOE+01 .lOOOE+01 

C .5000E+00 -.lOOOE+22 



UPPER BOUND 
.lOOOE+22 
.6000Ef01 
.lOOOE+22 



REDUCED COST 
0* 

.5000E-01 
0. 



CONSTRAINT SECTION 
name" SLACK ACTIVITY DUAL PRICE 

R0U*2 0. .5650E+01 

BOUNDA 0. -.1350E+01 

? END 

.400 CP SECONDS EXECUTION TIME 



RHS VALUE 
.5000E+00 
,7500E+01 



37 



4,4 Session 3: A Transportation Problem Example 



EZLP - VERSION 9/17/76 
. TYPE HELP IF YOU HAVE QUESTIONSj OTHERWISE PROCEED 
? TITLE TRANSPORTATION PROBLEM - SOLUTION VIA EZLP* 
7 MAX TRANSOBJ: 2Xlfl + 3Xlf2 + 4X2fl + 2X2r2 
7 ST SUPPLYi; Xlfl + Xlf2 =3 
7 AND SUPPLY2: X2fl + X2y2 = 4 

7 AND DEMANDIJ Xlfl + X2fl = 5 

7 AND DEMAND2: XI f 2 ^ X2f2 = 2 

7 and: all vars >= o 

7 PRINT BASIS 

7 USE RATIONAL PRIMAL 

** NO UNRESTRICTED VARIABLES IN THE MODEL ** 



HHt VARIABLE LIST 



Xlfl Xlf2 X2f 1 X2f2 

PHASE 1 ITERATION - 1 CURRENT OBJ VALUE = 14 
THE CURRENT BASIC VARIABLES ARE - 

ART*2 ART*3 ART*4 ART#5 

PHASE 1 ITERATION - 2 CURRENT OBJ VALUE = 8 

AT THIS ITERATIONf Xlfl ENTERED THE BASIS AND ART*2 LEFT 

THE CURRENT BASIC VARIABLES ARE - 

Xlfl ART#3 ART*4 ART*5 

PHASE 1 ITERATION - 3 CURREi i' OBJ VALUE = 4 

AT THIS ITERATIONf X2fl ENTERED THE BASIS AND ART*4 LEFT 

THE CURRENT BASIC VARIABLES ARE - 

Xlfl ART*3 X2fl ART*5 

PHASE 1 ITERATION - 4 CURRENT OBJ VALUE = 0 

AT THIS ITERATIONf XI f 2 ENTERED THE BASIS AND ART*3 LEFT 

THE CURRENT BASIC VARIABLES ARE - 

Xlfl Xlf2 X2f 1 ART«5 

PHASE 2 ITERATION - 1 CURRENT OBJ VALUE = 24 
THE CURRENT BASIC VARIABLES ARE - 

Xlfl Xlf2 X2fl ART*5 



1. 
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TRANSPORTATION PROBLEM - SOLUTION VIA EZLP, 
SOLUTION 



OBJECT 
Z 

ITERATIONS 



MAXIMIZE TRANSOBJ 
24 

1 



VARIABLE SECTION 
NAME ACTIVITY LEVEL LOWER BOUND 

Xl»l I 0 

Xl»2 2 0 

X2»l 4 0 



UPPER BOUND 
POS INF 
POS INF 
POS INF 



REDUCED COST 
0 
0 
0 



CONSTRAINTSECTION 
NAME SLACK ACTIVITY DUAL PRICE RHS VALUE 

0 3 1 

0 5 ,2 

0-14 
0 0 0 



SUPPLYl 
SUPPLY2 
DEMANDl 
DEMAND2 
? END 



♦413 CP SECONDS EXECUTION TIME 
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4,5 Session 4: A Branch and Bound Example 

If we consider the integer program 

Max + 
ST X^ + 3X2 < 9 
3X^ + X2 < 9 
X^, X2 >. 0 and integer 

described by the graph 




4.6 Session 5; A Sensitivity Analysis Example 



EZLP - VERSION 9/17/76 

TYPE HELP IF YOU HAVE QUESTIONS* OTHERWISE PROCEED 
?'TITL,E NODE 0 - SOLUTION VIA EZLP 
? max: X1+X2 
? ST: X1+3X2 <=» 9 
? and: 3X1+X2 <= 5> 

7 and: all vars >= o 

? use rational upper primal 

«# no unrestricted variables in the model ** 

** variable list *« 

XI X2 
NODE 0 - SOLUTION VIA EZLP 

S 0 L U,T I 0 N 



OBJECT MAXIMIZE R0U41 

Z 9/2 
ITERATIONS 3 

VARIABLE SECTION 

NAME ACTIVITY LEVEL LOWER BOUND UPPER BOUND REDUCED COST 

. XI 9/4 0 POS INF 0 

X2 9/4 0 POS INF 0 

CONSTRAINTS ECTION 

NAME SLACK ACTIVITY DUAL PRICE RHS VALUE 

R0M*2 0 1/4 9/4 . 

R0W*3 0 1/4 9/4 
? and: X:l<=2 

? TITLE NODE 1 - ADDITION OF ONE BOUND ON XI 
? USE RATIONAL UPPER PRIMAL 

** NO UNRESTRICTED VARIABLES IN THE MODEL ** 

#* VARIABLE LIST ** 

XI X2 
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NODE 1 - ADDITION OF ONE BOUND ON XI 



SOLUTION 



OBJECT 
Z 

ITERATIONS 



MAXIMIZE R0W*1 
13/3 

3 



VARIABLE SECTION 
NAME ACTIVITY LEVEL LOWER BOUND 

XI 2 0 

X2 7/3 0 

SLK#3 2/3 0 



UPPER BOUND 
2 

POS INF 
POS INF 



REDUCED COST 
2/3 
0 
0 



CONSTRAINT SECTION 
NAME SLACK ACTIVITY DUAL PRICE RHS VALUE 

RC}y*2 0 ,1/3 7/3 

R0W*3 2/3 0 2/3 

? and: X2 <= 2 

? TITLE NODE 2 - UPPER BOUNDS ON XI > X2 
? USE RATIONAL UPPER PRIMAL 

** NO UNRESTRICTED VARIABLES IN THE MODEL ** 

, ** VARIABLE LIST ** 



XI 



X2 



NODE 2 - UPPER BOUNDS ON XI f X2 



SOLUTION 



OBJECT 
2 

ITERATIONS 



MAXIMIZE R0U*1 
4 

3 



VARIABLE SECTION 



NAME ACTIVITY LEVEL 
XI 2 
X2 2 
SLK*2 1 
SLK*3 1 



LOUER BOUND 
0 

0 
0 
0 

46 



UPPER BOUND 
2 
2 

POS INF 
POS INF 



REDUCED COST 

i 
1 

0 
0 
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CONSTRAINT SECTION 
NAME SLACk'aCTIVITY DUAL PRICE RHS VALUE 

R0U*2 1 ^ ^ 

R0U*3 1 0 1 

? LIST 
ROUtl 

max: X1+X2 
R0Ut2' 

ST: X1+3X2 <= 9 
R0U»3 

and: 3X1+X2 <= 9 

R0Ut4 

and: all vars >= o 

R0U*5 

and: xi<=2 

R0U«6 

and: X2 <= 2 
7 CHANGE R0U*6 •<= 2'>= 3' 

? TITLE°*N0DE 3 - LOWER BOUND ON X2> UPPER BOUND ON XI 
? USE RATIONAL UPPER PRIMAL 

** NO UNRESTRICTED VARIABLES IN THE MODEL ** 
»* VARIABLE LIST ** 

XI X2 

NODE 3 - LOWER BOUND ON X2» UPPER BOUND ON XI 

SOLUTION 



OBJECT MAXIMIZE R0W*1 

Z 3 
ITERATIONS 2 

VARIABLESECTIO^N 

NAME ACTIVITy'lEVEl" LOWER BOUND UPPER BOUND REDUCED COST 

X2 3 3 POS INF .2 

SLK*3 A ^ 



POS INF 0 



CONSTRAINT SECTION 

NaSe sZACK'AC^IVn^ DUAL PRICE RHS VALUE 

R0W*2 0 ^ ^ 

R0W*3 .6 0 * 
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? DELETE R0Wt6 
? LIST R0W*5 
RDWI5 

and: X1<=:^2 
? CHANGE R0W*5 •<=2">=3" 

and: X1>=3 

? TITLE NODE 4 - LOWER BOUND ON XI (FINAL NODE) 
? USE RATIONAL UPPER PRIMAL 

NO UNRESTRICTED VARIABLES IN THE MODEL ** 
** VARIABLE LIST 

XI X2 

NODE 4 - LOWER BOUND ON XI (FINAL NODE) 

SOLUTION 



OBJECT MAXIMIZE R0W#1 

Z 3 
ITERATIONS 3 

VARIABLESECTION 
NAME ACTIVIT~LEVEr LOWER BOUND UPPER BOUND REDUCED COST 

XI 3 3 ^ 

SLK*2 ^ ^ 

CONSTRAINT SECTION 



POS INF 0 



NAME 

R0U*2 

R0W*3 



"sLACK^ACTIVITY DUAL PRICE RHS VALUE 

0 1 0 



? LIST 
R0U*1 

max: X1+X2 

R0U*2 

ST: X1+3X2 <= 9 
R0U*3 

and; 3X1+X2 <= 9 
R0U#4 

and: all vars >= o 

R0U*5 

and: xi>=3 

? END 

1*152 CP SECONDS EXECUTION TIME 
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EZLP - VERSION 12/6/79 - RANGE TEST^, 

TYPE HELP IF YOU HAVE QUESTIONSf OTHERWISE PROCEED 
7 max; 3X1+4X2 
7 st: X1<=3 
7 AND 5 X2<=5 
7 and: X1+X2<=7 
7 and: X1»X2>=0 
7 USE UPPER PRIMAL 

VARIABLE LIST - 

XI X2 

NO UNRESTRICTED VARIABLES IN THE MODEL 



SOLUTION 



OBJECT 
Z 

ITERATIONS 



MAXIMIZE R0U#1 
*2600E+02 

3 



VARIABLE SECTION 
NAME ACTIVITY LEVEL LOWER BOUND 

XI *2000E+01 0. 

X2 «5060E+01 0. 



UPPER BOUND 
*3000£+01 
*S000E+01 



REDUCED COST 
•lOOOE+01 



•3000E+01 



CONSTRAINT SECTION 
NAME SLACK ACTIVITY DUAL PRICE 

R0U#4 0. 
7 RANGE ALL 
RANGE INFORMATION 
CONSTRAINT NAME LOW 

R0W44 •50000E+01 
VAR TYPE NAME 

0. 



RHS VALUE 
♦2000E+01 



CURRENT HIGH 
70000E-f01 •BOOOOE-fOl 
LOW CURRENT HIGH 



BASIC R0W4r4 XI 

NON-BASIC X2 

NON-BASIC SLK«2 
? END 

♦320 CP SECONDS EXECUTION TIME 



•30000E+01 «40000E+01 
♦30000E+01 .40000E+01 ♦lOOOOE+21 
-♦lOOOOE+21 0. •30000E+01 



EKLC 
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APPENDIX A 



A SIMPLIFIED USER'S 
MANUAL FOR EZLP 



The first three pages of this appendix serve as a reasonable 
handout for most beginning users. The remaining nine pages pro- 
vide more detailed discussion of the topics covered in the first 
three pages. By employing the "HELP" command the user can obtain 
any or all of this information during execution of EZLP. 
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EZLP: AN INTERACTIVE COMPUTER PROGRAM DESIGNED TO SOLVE 
STUDENT-ORIENTED LINEAR PROGRAMMING PROBLEMS. t 



1; General 

The first word of each line is a keyword, and indicates the function 
of the input line. The keywords are "MEN" or "MAX" for the objective 
function, "ST" for the first constraint, followed by "AND" for each addi- 
tional constraint. Each name (e.g. variable name) consists generally of a 
combination of up to 8 alphabetic and numeric characters with the first 
character being alphabetic. 

Model Entry 

Model entry statements are composed of a keyword, an optional name, 

a mandatory colon, and either an objective function or a constraint. 

Example of a model entry: 

MAX; 2PR0D1 + 3PROD2 - 4 COST 
ST; PRODI + PROD2<=150 
AND: COST >= 5 
AND; ALL OTHER VARS >= 0 

Editing 

The input mode;! can be edited by "DELETE" and "CHANGE" statements. 
Adding a constraint is accomplished by simply typing the constraint. 
Examples : 

AND NEWROW: 5COST-PRODl>=20.23 
CHANGE NEWROW "PR0D1"PR0D2" 
DELETE NEWROW 



tEZLP was developed in the School of Industrial and Systems Engineering, 
Georgia Tech, Atlanta, Georgia 30332 under NSF grant //SED75-17476. 
John J. Jarvis, project director; Frank H. Cullen and Chris Papaconstadopoulo 
research assistants. 



EZLP internally numbers the input model lines and if the optional name 
before the colon is omitted during model entry, a name of the form 
"ROW//n" (e.g., R0W//6) is assigned as a default. 

The model can be listed either in total or one line at a time as 
follows : 

LIST (THE ENTIRE MODEL) 

LIST C0NSTR2 (LINE"C0NSTR2" ONLY) 

Continuatioji of the input line ±b achieved by placing an ampersand (&) 

after a complete name. Exanqple: 

AND: HEAT - 2.34W00D & 
-6.45POWER>=»16.4 

Specifying Output 

EZLP always outputs the final optimal solution. Other output can 

be requested after every iteration or after every n iteration. Examples: 

PRINT BASIS 5 (The names of the basic variables every 

fifth iteration) 
PRINT TABLEAU, 2 (The tableau at every other iteration) 
PRINT VARS (The value of primal and dual variables) 
PRINT NONE (Resets print specs to only final solution) 
PRINT INITIAL, FINAL TABLEAU 
PRINT ALL (Prints everything) 

Specifying the Method of Solution 

After model entry, editing, and output specification, the USE 

statement triggers the optimization. Examples: 

USE PRIMAL 

(Ordinary simplex method) 
USE RATIONAL PRIMAL 

(Ordinary simplex method with rational arithmetic) 

USE UPPER DUAL 

(Lower-upper bounded dual simplex method) 
USE RATIONAL UPPER PRIMAL 

(Lower-upper bounded simplex method with rational 
arithmetic) 

Upon completion of the solution attempt, EZLP returns to the editing 
phase. 
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Sensitivity Analysis 

After executing any of the USE commands to obtain an optimal solution, 
the user may obtain sensitivity information by use of the RANGE command. 
Application of the ^ range command determines lower and upper limits on 
the objective coe££ici^rlts and/or right-hand-side constants which keep 
the current optimal basis. 
Examples : 

RANGE RHS R0W//6 
RANGE OBJ X54 
RANGE OBJ ALL 
RANGE ALL 

Restarting and Stopping EZLP 

If another model is to be entered from scratch, type "RESTART", and 
EZLP will re-initialize the model file area. If EZLP is to be terminated, 
type "END". 

File-Handling Capabilities 

EZLP has the ability to use external mass storage files for both 
input and output. Information on these options can be obtained by con- 
sulting Section 5 "FILE-HANDLING". 
simple Example of a Complete EZLP Run 

MAX: 2X1+3X2+4.5X3 

ST: X1+X2 <=75.3 

AND: X2 +X3 <=^5 

AND: ALL VARS >=0 

USE PRIMAL 

END 

The Help Command 

During execution EZLP permits the user to obtain specific information 
concerning its use. The user may obtain a short introduction to EZLP and 
its use by typing 

HELP 
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If the user desires more specific instructions, he may type "HELP<keyword>", 
(e.g., HELP MODEL) where the acceptable keywords are: 

General keywords 

EDIT EXAMPLES FILES KEYWORDS 

MODEL SOLVING BRIEF 

Specific keywords 

ADD ADVANCED CHANGE CONT 

CONS DELETE OBJ PRINT 

RUN ■ SAVE TITLE USE 

ALTOBJ NAMES LIST 



2; The Model 

Providing a Title for the Kodel 

EZLP penults the Input of a title for the model. This title will 
appear just before the optimal solution Is printed. The title command 
consists of: 

1. The keyword "TITLE" 

2. The title text 

Example: 

TITLE* THIS IS MODEL 4 
Variable and Constraint Names 

In entering the model, the aser has the ability of assigning his 
own names to the variables and the constraints. These names must be from 
one to eight characters long, begin with an alpha character, and contain 
no special characters, A variable name may contain a comma provided that 
the comma separates two numerics • Spaces are not allowed within names, 
EZLP generates constraint names for unnamed rows and variable names for 
slack and artificial variables. These take the form: 

ROW//n - for generated constraint names 
SLK#n - for generated slack variable names 
ART#n - for generated artificial variable names 

Continuation of Lines 

In the event that an Input line exceeds 80 characters, continuation 
Is accomplished by placing an ampersand (&) after a complete name and 
resuming Input on the following line. 
Objective Functions 

EZLP allows for the specification of two kinds of objective func- 
tions: primary and alternate. For the simple model there usually will 
not be an alternate objective function. In essence, this concept allows 
the user to enter more than one objective function and optimize the 
various objective functions subject to the same constraints during the 



course of the interactive session. 

Primary objective function - The entry of the objective function 
consists of: 

1. The keywords "MAX", "MIN" 

2. An optional objective function name 

3. A mandatory colon 

4. And a linear combination of user-defined variable names. 
If the optional objective function is omitted, EZLP will generate a name 

of the form ROW//n for use in editing and output. Examples: 
MIN: 2X1 + 2X2 + 3X3 

MAX MYOBJ: 3.54 COLUMN1-4.543COLUMN2 + 6.25 

MINIMIZE: 5.76 XI, 2 - 4.33 XI, 3 + 5.45 X2,l & - 6.43 X2,3 

Alternate Objective Functions - Alternate objective functions are 

entered in the same way as the primary objective function, excepc that 

the keyword "MIN" or "MAX" is replaced by the keyword "ALSO". The use of 

an alternate objective functicn is discussed in Section 4 "Solvinj? the 

Model". Examples: 

ALSO: 2X1 - 3X2 4X3 

ALSO 0BJ2: 3,45 CGLUMNl - 4.511COLUMN2 

Constraints 

Constraints are divided into three generic types. 

1. Simple arithmetic constraints 

2. Range constraints 

3. List constraints 

Each is discussed below. 
Simple Arithmetic Constraints 

A simple arithmetic constraint consists of 

1. The keyword "AND" or "ST" 

2. An optional constraint name 

3. A mandatory colon 

4. A linear combination of user-defined variable names 

5. A relational operator (=',<=,>=) 

6. A second linear combination of user-defined variable names. 
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It is not allowable to have the same variable name in both 4 and 6 above. 
Examples: 

AND: X1+X2 =7 

AND MYCSTR: 5X1 + 8.3 X2 >= X3 +4 

Range Constraints 

EZLP allows the entry of bounded arithmetic expressions (range 
constraints). Range constraints consist of the following: 

1. The keyword "AND" or "ST" 

2. An optional user-defined constraint name 

3. A mandatory colon 

4. A constant (const an t-1) 

5. An inequality relational operator (>= or <=) 

6. A linear combination of the user-assigned 

7. An inequality operator (>= or <=) 

8. A constant (constant-2) 

The restriction on range constraints aro. that the two inequality 
operators must be identical and that the two constants must be consis-- 
tent. (i*e. if the inequality operators are cons tan t-1 must be 
<« cons tan t-2 ) . 

AND: 4 <= 3X1+4. 3X2<= 6.2 
AND BOUNDl: 7.2>= 3X2+HEAT - 5P0WER>= 5 
List Constraints 

EZLP allows bounds for collective groups (or lists) of user-defined 
variable names to be specified in list constraints. The variable lists 
can be either explicit or implicit. 
Explicit List Constraints 

(These constraints consist of:"^ 

1. The keyword "AND" 

2. Aji optional constraint name 

3. A mandatory colon 

4. A list of variable names 

5. A relational operator 

6. A constant 
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The variable list is simply a list of variable names separated by 
commas. If the "UPPER" option is not specified in the "USE" statement, 
those list constraints in which the constant is not 0 are considered as 
explicit rows in the simplex tableau. Examples: 
AND: X1,X2,X5 >=0 

AND UBND: HEAT, POt^ER, LIGHT <=100.3 
AND: IffVAR, YOURVAR URS 

(Here URS = unrestricted in sign and takes the 
place of 5 and 6 above.) 

Bounded lists are also permitted, for example 

AND: 4< = X1,X2,X5< =7 
Implicit List Constraints 

Special abbreviations are available to describe either all variables 
or variables not appearing in another list constraint. Examples: 

AND: ALL VARS> = 0 
AND: ALL VARS< = 1 
AND MYBOUND: ALL OTHER VARS >= 3 

The phrase "ALL VARS" is a synonym for "all variables", while the phrase 

"ALL OTHER VARS" refers only to those variables not included in some 

earlier list constraint. 
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3; Editing the Model 
Adding Rows 

New rows may be either appended to the current model file or Inserted 
within the current model file. 

a. Appending rows to the end of the model. This is easily accomplished 
by simply typing in the row exactly as it was done during model entry. 
Example: 

AND: X1+X2 <- 7 
ALSO: 3.5X1+4.6FL0W1 

b. Insertion of rows within the model file - Rows may be Inserted 
within the model file by simply typing in: 

INSERT AFTER <old-row> <model entry statement> 

or 

INSERT BEFORE <old-row> <model entry statement> 

For example, if the current model file contained: 

MIN OBJ: 2X1+3X2 
ST CON: Xl+X2<=3 
AND: ALL VARS >=0 

an entry of 

INSERT AFTER CON AND C0N2: X1+2X2 >=1 

would result in a model file of 

MIN OBJ: 2X1+3X2 
ST CON: Xl+X2<=3 
AND C0N2: X1+2X2 >=1 
AND: ALL VARS >=0 

Deleting Rows 

The deletion of a row is accomplished, by entering DELETE <row name> 

where <row name> is the user-assigned name, or in the absence of such, 

takes the form "R0W#n", If a delete is followed by the addition of a 

row having the same name, the new row is inserted in the model file in 

the same place. Examples: 

DELETE MYCSTRNT 
O . DELETE ROW// 7 
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an entry of 

CHANGE R0W//5 "3"X24-4" 
would result in R0W//5 becoming 

AND; 2X1+X2+4X3<=5 
whereupon an entry of 

CHANGE R0W//5 "3<"" 
would yield R0W//5 as 

AND: 2X1+X2+4X==5 
Changes involving row names and/or continuation characters (&) 
are illegal. Changes of this tjrpe should be accomplished by a "DELETE" 
followed by retyping the entire row. 
Listing the Model 

The list command allows the user to list the current contents of the 
model file in total or in part. Two options are available: 

1. LIST (lists the whole model) 

2. LIST <row name> (lists only row <row name>) 

Examples : 

LIST 

LIST R0W#5 
LIST C0NSTR3 

Changing Rows 

To change a character string in a specified row (say R0W//5) , the 
following is entered 

CHANGE R0W#5 "<stringl>"<string2>" 
The double quote (") is the only allowable delimiter. For example if 
R0W//5 was originally 

AND: 2X1+3X3<=5 
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4: Solving the Model 

Specifying Alternate Objective Functions 

The user may specify an alternate objective function to be opti- 
mized by typing: 

ALTOBJ MIN <row name> 

or 

ALTOBJ MAX <row name> 
where <row name> is the name of an objective function in the model. 
Examples: 

ALTOBJ MAX R0W//2 
ALTOBJ MIN 0BJ4 

This objective function specification remains in force until such time 
as a "RESTART" or another "ALTOBJ" command is entered. 

The user may identify the current specified alternate objective 
function row name by typing: 

ALTOBJ STATUS 
Specifying Output 

The PRINT command is used to specify the type and frequency of out- 
put to be printed during the optimization process. Parameters which 
can be used are: 

1. VARS prints the values of the non-zero primal 

and dual variables in the current tableau. 

2. BASIS prints the current basic variables and 

denotes entry and exit activities 

3. TABLEAU prints the current tableau and the updated 

objective function row 

4. ALL Synonym for "VARS, BASIS, TABLEAU" 
Parameters 1-4 can optionally be followed by an integer indicating the 
frequency with which the output is to be given. If omitted, the default 
value is 1 (output after every iteration). Examples: 

PRINT TABLEAU, BASIS 

PRINT VARS 5 
i^n^i-" PRINT ALL 4 
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Initial and/or final tableau output can also be indicated. In this case, 

the integer described does not apply and is ignored if present. Examples: 

PRINT INITIAL TABLEAU 
PRINT FINAL ALL 

PRINT INITIAL, FINAL BASIS TABLEAU 
If print specifications are to be altered, the proper action is to enter 
PRINT NONE 

which resets print parameters to the default mode. 
Specifying the Method of Solution 

The USE command is entered when an attempt to solve the input model 
is to be made. The following parameters are legal (the order of the 
parameters is important) 

1. RATIONAL - (Optional) Rational arithmetic is to be used. 

Rational arithmetic is 3 to 4 times slower 
than real arithmetic, and can only solve 
problems half the size, 

2. UPPER - (Optional) Lower-upper bounded simplex is 

to be used. List constraints are implicit 
in the tableau. 

3. PRIMAL 

or DUAL - A specification of the type simplex method 
to be used, "PRIMAL" refers to the simplex 
method and "DUAL" refers to the dual simplex 
method. 

Examples: 

USE RATIONAL PRIMAL 

USE DUAL 

USE UPPER DUAL 

USE RATIONAL UPPER PRIMAL 

When possible, "UPPER" should be specified for dual aimplex, as this im- 
proves the chance of obtaining a starting dual feasible basis. 
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5; Sensitivity Analysis 

EZLP contains capability for sensitivity analysis of an optimal solu- 
tion of a model. This is accomplished by use of a RANGE command. The 
format of this command is: 

1. The keyword "RANGE". 

2. User defined options for ranging ^ "RHS", "OBJ" or 
"OBJFCN", "ALL". 

3. Optlom.''. UL-.ar defined variable names or row names, or the 
optional modifier "ALL". 



EXAMPLES: 



RANGE 
RANGE 
RANGE 
RANGE 
RANGE 



RHS 
OBJ 
OBJ 
OBJ 
ALL 



R0Wi?4 



X55 
ALL 
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6; File-Handling 

Input From an External File 

The "RUN" connnand enables the user to use an external file as a 
store of input statements and commands. Upon entering the command 
RUN <file name>, EZLP opens the local file <file name> and references 
this file for all subsequent input commands, until such time as an "END" 
statement is encountered or an end--of-file condition on <file name> exists. 
If an end-of-file is encountered, control returns to the live user. The 
form of the file should be 80 characters per line. 
Output to an External File 

The "SAVE" command enables the user to place the current concepts 
of the model file into a local file. The form of this file is 80 
characters per line and editable by the system editor or usable as 
input to 0. later execution of EZLP. ENTER : 
SAVE <file name> 
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6; Batch Processing 

EZLP can be used in a batch environment in much the same way that 
it is used interaccively. The sole restriction is that the command BAT' 
must be the first entry in the input deck to EZLP. Omission of this 
command can result in an infinite print loop at job termination time. 
Aslo the command END must be the last entry in the input deck to EZLP. 
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Advanced Example 



TITLE ** ADVANCED MODEL ** 

MAX OBJ: 2INTERST1+3.24INTERST2-5CAPITAL 

ALSO OBJ 2: 3.4INTERSTH-2.54INTERST2-5 CAPITAL 

ST CONSTRl: INTERST1-4INTERST2 = 108 

AND MINCAP: CAPITAL> =4.6 INTERSTl + 5.7INTERST2 

AND MAXCAP: 4 CAPITAL< = 10345.65 - 3.224 INTERSTl & 

-5.231 INTERST2 
AND CAPBND: 800 <=CAPITAL <= 10000 
AND INTBND: INTERSTl, INTERST2 10825 
AND NONNEG: INTERSTl, INTERST2 >= 0 
CHANGE MINCAP "4.6"4.76" 
CHANGE INTBND "825". 825" 
PRINT ALL 
USE UPPER PRIMAL 
DELETE NONKEG 

AND NEWCSTR: INTERST2 >= 1.342 

AND UBND: INTERSTl, INTERST2,CAPITAI, <= 100000.3 
ALTOBJ MAX OBJ 2 

PRINT FINAL TABLEAU, BASIS, VARS 
LIST 

USE UPPER DUAL 
END 
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